home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / wpcvt21 / wpcvt.doc < prev    next >
Text File  |  1994-01-15  |  7KB  |  163 lines
  1.                         WPCVT White Pages converter utility
  2.                     WPCVT 2.0 (C) 1994 by Dean R. Madsen, KE0WO
  3.  
  4. Brief notes for the WPCVT program:
  5.  
  6. -------------------------What does it do?-----------------------------------
  7.  
  8.         One always wants the most complete White Pages database possible, and
  9. it seems that someone else always has more info in their WP database.  They
  10. may offer to send a copy of it to you for you to  replace your smaller WP
  11. database with, but then you would loose any info that the larger database may
  12. not have.  My solution to this problem is the WPCVT program.  What this
  13. program will do is take the larger WP database that someone sent you, process
  14. it and turn it into (a) WP update message(s) to be imported into your BBS
  15. where the BBS will ADD the new info into its existing WP database.
  16.  
  17. --------------------------Using it-------------------------------------------
  18.  
  19. To use the WPCVT program you will require 2 DOS parameters to go with it.
  20.  
  21. The first is the name of the WP database to process, such as WP.SYS (which
  22. is usually the case).
  23.  
  24. The second parameter is the output file that the WP update message will be.
  25. This could be \FBB\MAIL.IN so that you won't have to do anything for the
  26. BBS to import the new data.  If you do output the data into the MAIL.IN file
  27. in a multitasked enviornment with the FBB BBS still running, you have the
  28. problem that FBB will start to import the MAIL.IN before WPCVT is finished
  29. writeing it.  If you decide to direct the output to the MAIL.IN file, you
  30. will want to use the A option described in the next section.
  31.  
  32. The (optional) third parameter.  This parameter lets you specify two options
  33. for the output of the WPCVT program.
  34.  
  35. A option -  This option will Append the output of the WPCVT program to the
  36.             file specified in the second parameter.  If the file doesn't
  37.             exist, then the WPCVT program will create it.
  38.  
  39. I option -  Create individual files starting with FILENAME.001 and
  40.             incredimenting the file number for each update message
  41.             (automatically enables the Split option).  This option
  42.             is useful for using MAILREN to import a new update message
  43.             hour.  Make sure you do not specify an extension in the
  44.             second parameter: WPCVT \FBB\SYSTEM\WP\WP.SYS MAIL -I
  45.             Do not even include a "." in the second parameter!
  46.  
  47. O option -  Output the WP update info in MESS.WP form:  doesn't make a
  48.             message.  This is useful for creating a file for the WPHB
  49.             program to cross reference the White Pages with the HAMBASE
  50.             callsign database program, filling in any missing info it may
  51.             have.
  52.  
  53. S option -  This option will create multiple short WP update messages
  54.             instead of one big long one (about 15K each).
  55.  
  56.  
  57. The options entered in the third parameter in any order.  You may even 
  58. include other characters with them.
  59.  
  60. Works:                      Doesn't work:
  61. A                           A S
  62. S                           A__ S     <--- No spaces allowed!
  63. -A                          S   A   
  64. -S
  65. -AS
  66. -SA
  67. ****SA**
  68.  
  69. You may use a fourth parameter as the @ callsign for the update messages.
  70. This allows sending your entire white pages (as update messages) to another 
  71. station over the air (I advise you to use the -SI options to create MAIL.001
  72. type files for MAILREN to rename every so often for import into the BBS).
  73.  
  74. When the program is used, this is what the command line may look like:
  75.  
  76. WPCVT \FBB\SYSTEM\WP.SYS \FBB\MAIL -IS KE0WO
  77.  
  78. This would multiple MAIL.### files in my \FBB directory, which MAILREN would
  79. then import one every hour.  After being imported, the BBS will "chew"
  80. on it a while and update is own WP database.
  81.  
  82.  
  83. -----------------------------Conclusion-------------------------------------
  84.  
  85. 1. This software is freeware to the amateur community. It may not be sold.
  86.    It may be freely copied and distributed in its original form, but at no 
  87.    charge exceeding the medium and shipping.
  88.  
  89.    I am tired of logging on to telephone bulletin boards and see my stuff
  90.    with strange .ARJ and other extensions, under different file names.  I
  91.    request that you leave the archive unchanged, as I released it.  If you
  92.    want to upload your white pages in the converted form, do it in a
  93.    seperate file.
  94.  
  95. 2. No warranty is expressed or implied and incidental damages resulting from
  96.    the use of this software are solely the responsibility of the user. While
  97.    the software works fine, and I am willing to give it to the amateur 
  98.    community, I am not willing to assume any liabilty for it crashing your
  99.    computer or its peripherals. (It has not done that on any machine we have
  100.    run it on...this is just legal junk to prevent someone from holding me
  101.    responsible for being generous enough to give this utility away as a 
  102.    service to the FBB community.)
  103.  
  104. 3. Feedback on desired features, changes, bugs, etc. are encouraged. 
  105.  
  106. 4. Let me know if a particular program is worth maintaining and updating.
  107.    I am finding myself with limited time and multiple programs that I could
  108.    work on.  It would help to know which programs are worth updating the
  109.    most (taking into consideration number of people who find it useful,
  110.    ideas for new features, etc).
  111.  
  112.    This new version was due an inquiry by SM2IRZ.  Previously I had been
  113.    playing with the file servers (which are currently in the beta test stage).
  114.    I didn't have any immediate plans to release a new version until the
  115.    message asking about it.
  116.  
  117.  
  118.  
  119.  
  120. Good luck and 73,
  121. Dean - KE0WO
  122.  
  123.  
  124. US Snail:  
  125.  
  126.  Home:     Dean R. Madsen, KE0WO
  127.            P. O. BOX 303
  128.            Storm Lake, IA  50588
  129.  
  130.  College:  Dean R. Madsen, KE0WO
  131.            Wallace 7348 Lancelot
  132.            Iowa State University
  133.            Ames, IA 50013
  134.  
  135. Packet:    KE0WO @ KE0WO.#NWIA.IA.USA.NA
  136.  
  137. Internet:  dmadsen@iastate.edu
  138.            MADSENDEAN@BVC.EDU (forwarded to above address when at school).
  139.  
  140. Phone:
  141.  
  142. Voice:     (515)  296-9471  -  Your dime.  I am usually around most weeknights
  143.                                (Sunday-Thursday), but my schedule changes
  144.                                unexpectedly.
  145.  
  146.  
  147. Voice:     (712)  732-2081  -  Your dime.  Your best chances of catching me at
  148.                                home are on a weekend when I am home, or when
  149.                                on break.
  150.                                
  151.                                
  152.  
  153. Data :    (712)  732-3767  -   14400,N,8,1 .   Enter your call at the prompt,
  154.                                then type Y to proceed.  
  155.                                Latest KE0WO servers/utilities in the SERVERS
  156.                                subdirectory of my file section in FBBDOS.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.